home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / PWAULTP3.ZIP / PWAPRGMS.A02 / PWA95 / PWADTC01.ZIP / DTC.DOC < prev    next >
Text File  |  1995-02-19  |  4KB  |  97 lines
  1.  
  2. +-----------------------------------------------------------------------------+
  3. | Download.TXT Cleaner v0.1 (beta)                                            |
  4. | Written by Drew [PWA]                                                       |
  5. | Docs Last Updated 02-19-95                                                  |
  6. +-----------------------------------------------------------------------------+
  7.  
  8.  
  9. +-----------------------------------------------------------------------------+
  10. | 0. Table of Contents                                                        |
  11. +-----------------------------------------------------------------------------+
  12.     1. Introduction
  13.     2. Installation
  14.     3. Configuration
  15.     4. General Notes
  16.     5. Last Words
  17.  
  18.  
  19. +-----------------------------------------------------------------------------+
  20. | 1. Introduction                                                             |
  21. +-----------------------------------------------------------------------------+
  22.     This utility will shrink/clean your download.txt file.  It can remove
  23. entries (for):
  24.  
  25.     1. Non-existent files in specified (upload) directories.
  26.     2. .QWK transfers
  27.     3. .CAP (message captures)
  28.     4. Exclude according to specified user names.
  29.  
  30. This is ideal for other utilities which scan the download.txt file for their
  31. purposes (ie: Nukers, Weekly/Monthly bulletin generators, download counters,
  32. etc.).
  33.  
  34.  
  35. +-----------------------------------------------------------------------------+
  36. | 2. Installation                                                             |
  37. +-----------------------------------------------------------------------------+
  38.     It is suggested to put this utility in its own directory.  This is not
  39. mandatory, but it's good for organization. :)
  40.  
  41.  
  42. +-----------------------------------------------------------------------------+
  43. | 3. Configuration                                                            |
  44. +-----------------------------------------------------------------------------+
  45.     Edit DTC.CFG for all options.  It's relatively short and simple, so should
  46. be painless as well.
  47.  
  48.     If you wish to scan multiple directories to remove non-existent files,
  49. make sure you specify the directories in DIRS.CFG, one per-line, and say "yes"
  50. to line 7 in DTC.CFG.
  51.  
  52.     If you wish to exclude transfers made by specific users, put the users's
  53. names in USERS.CFG, one per line, and say "yes" to line 6 in DTC.CFG.
  54.  
  55.  
  56. +-----------------------------------------------------------------------------+
  57. | 4. General Notes                                                            |
  58. +-----------------------------------------------------------------------------+
  59.     I only know of one other program that did anything similar to this.  But
  60. it was a PPE and took *forever* to run.  Hence, I decided to write this up and
  61. have it run as quickly as possible.
  62.  
  63.     This utility does *not* alter the original download.txt file.  This is a
  64. safety precaution so in case something bad happens, you know it's not this
  65. utility's fault. :)  The new output file is specified in the config file, so
  66. you, the sysop, will have to manually rename/delete files.  Basically, the
  67. ideal steps to take after running this utility are:
  68.  
  69.     1. Rename download.txt to download.bak
  70.     2. Rename output.txt to download.txt
  71.  
  72. See EXAMPLE.BAT for exactly what I mean if you do not understand this.
  73.  
  74.     This version is a **beta**.  There are a couple of more features that
  75. I wish to add, but before doing so, I'd like more input and hence, am
  76. releasing this.
  77.  
  78.     This utility was written in C and compiled with Borland C++ 3.1.  It has
  79. been tested under a DOS/Desqview environment, but should work with OS/2 as
  80. well.
  81.  
  82.  
  83. +-----------------------------------------------------------------------------+
  84. | 6. Last Words                                                               |
  85. +-----------------------------------------------------------------------------+
  86.     Thanks to Raw Liquid for bringing up this idea.  I've had this thing
  87. laying around for ages, and if it weren't for him, I would never have gotten
  88. around to finishing it up. :)
  89.  
  90.     Otherwise, if you need to reach me for some reason, you can send internet
  91. email to "drew@xinet.com", or leave me a message on Attitude Net, or call my
  92. board: The Silicon Phalanx at 310-575-8567 and apply for access.
  93.  
  94. Peace,
  95. --Drew
  96.  
  97.